home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / netbsd / experimental / bin10a / cirrus-current.readme < prev    next >
Text File  |  1995-03-04  |  3KB  |  101 lines
  1.  
  2. WHATS NEW
  3.  
  4.     The main addition is dynamically loadbale monitor support and
  5.     support for NetBSD-current's zbus.  (grfclx is no longer used).
  6.     Other enhancements include:
  7.  
  8.         16 and 24 bit support
  9.         reinitialization problem with the spectrum fixed
  10.         frequency value calculator is MUCH better now 
  11.         upper frequency limit increased to 115Mhz (watch out!)
  12.         Cirrus Console!!!
  13.  
  14. INSTALLING GRF_CL
  15.  
  16.     To add this driver to a NetBSD-current kernel, replace files in
  17.     /sys/arch/amiga/dev with the ones in dev/ in this archive.
  18.  
  19.     Modify your config.new file and add the lines:
  20.  
  21.         options GRF_CL5426
  22.         options CL5426CONSOLE
  23.         grfcl* at zbus0
  24.         grf3 at grfcl?
  25.         ite3 at grf3
  26.  
  27.     In the appropriate spot (It should be obvious from the organization
  28.     of the config.new file).  The modify files.amiga.newconf and add an
  29.     entry as follows:
  30.  
  31.         device    grfcl at zbus: grfbus
  32.         file    arch/amiga/dev/grf_cl.c        grfcl needs-flag
  33.         file    arch/amiga/dev/ite_cl.c        grfcl ite
  34.  
  35.     That should be all you need to do to add grf_cl to the kernel.
  36.  
  37.  
  38. LOADABLE MONITORS
  39.  
  40.     In order for grf_cl to work, you must load monitor definitions into
  41.     it after boot.  To do this, use the program 'grfconfig'.  The
  42.     command:
  43.  
  44.         grfconfig -d /dev/grf3 grfmodes
  45.  
  46.     Will load up monitor definitions from the file 'grfmodes' into the
  47.     driver.  The definition are stored in the file one to a line in the
  48.     format:
  49.  
  50.      num clock wid hi dep hbs hss hse hbe ht vbs vss vse vbe vt
  51.  
  52.     Where:
  53.     
  54.     num is the mode_number slot (1-8,c) you want the mode loaded into.
  55.     clock is the pixel clock (in hz).
  56.     wid is the pixel width of the display.
  57.     hi is the pixel height of the display.
  58.     dep is the bit depth of the display
  59.     hbs, hss, hse, hbe and ht are the horizontal parameters
  60.     vbs, vss, vse, vbe and vt are the vertical parameters.
  61.  
  62.     NOTE: THE WAY MODES ARE DEFINED IS SLIGHTLY DIFFERENT FOR THIS
  63.     GRF_CL THAN THE PREVIOUS!  You must use the "true" horizontal &
  64.     vertical parameters for the display.  For interlace modes, the
  65.     vertical paramters should be specifying a display half as tall
  66.     as the width field says it should be.  For doublescan it should
  67.     be twice as tall.  
  68.  
  69.     To change the depth of the display, simply alter the depth field,
  70.     grf_cl will take care of the rest. :-) (some depths may require
  71.     frequencies which are out of range, however)
  72.  
  73.     If you want to change the dsplay mode of the console, use the the mode
  74.     number 'c' and a depth of '4'.  Grfconfig will automatically calculate
  75.     the text dimensions for you from the pixel dimensions in the mode.
  76.  
  77.     The example modes in etc/grfmodes should help clarify this a bit.
  78.  
  79. SETUP
  80.  
  81.     Put grfconfig in /usr/sbin.  Put a monitor modes file called
  82.     'grfmodes' in etc.  Then put the line
  83.  
  84.         grfconfig -d/dev/grf3 /etc/grfmodes
  85.  
  86.     in your /etc/rc.local somehwere towards the end.
  87.    
  88. OTHER
  89.  
  90.     See the source for grfconfig for complete documentation on it.
  91.  
  92.     egs2grfconfig is a small prgram to convert EGS monitor mode
  93.         values into values suitable for grfconfig.  Note that
  94.         the values may need some tweaking because of differences
  95.         in the way modes are loaded in EGS & grf_cl.
  96.  
  97.     gfxtest is a small, incomplete program which opens up a gfx mode
  98.         waits for you to press return and closes the display.  Its
  99.         useful for testing out monitor modes. (not much else :-))
  100.  
  101.